home *** CD-ROM | disk | FTP | other *** search
/ Fritz: All Fritz / All Fritz.zip / All Fritz / FILES / PROGMISC / GPSA1.LZH / GPSA212A.EXE / README.1ST < prev    next >
Text File  |  1993-01-08  |  11KB  |  263 lines
  1.                GPSA Version 2.12 <ASP> January 12, 1993
  2.                ========================================
  3.  
  4. What is GPSA?
  5. ==============
  6.  
  7. The General Purpose System Analyzer (GPSA) is a comprehensive system
  8. analysis and documentation package for professional programmers who
  9. maintain and enhance mainframe COBOL systems. 
  10.  
  11. With GPSA, all COBOL source code for an application or sub-system is
  12. loaded into an Omni-Relational Model (ORM). All system components
  13. (data-names, paragraph-names, programs, copybooks) and their
  14. interrelationships are stored within the ORM.
  15.  
  16. GPSA provides the facility to view the ORM components through nine
  17. interactive review screens, and to generate 26 system-wide analysis
  18. and documentation reports.
  19.  
  20.  
  21. Who uses GPSA?
  22. ===============
  23.  
  24. GPSA is designed as a support tool for professional programmers who
  25. maintain mainframe COBOL systems. Anyone responsible for maintenance
  26. activities (eg, impact analysis, documentation, system understanding,
  27. quality assurance, and re-engineering) will find GPSA a welcome
  28. addition to their programmer's toolbox.
  29.  
  30. You must be able to transfer COBOL source code to a storage device
  31. (eg, hard disk drive or file server) which is accessible to the PC
  32. where GPSA is installed. Source code does NOT need to be compiled.
  33.  
  34.  
  35. Read README.1ST
  36. ================
  37.  
  38. This README.1ST file contains important information about installing
  39. and using GPSA. Please read the entire file before proceeding.
  40.  
  41. You can print this file with the following DOS command:  
  42.  
  43.      copy readme.1st prn
  44.  
  45.  
  46. ======================================================================
  47. This program is produced by a member of the Association of Shareware
  48. Professionals (ASP).  ASP wants to make sure that the shareware
  49. principle works for you. If you are unable to resolve a shareware
  50. related problem with an ASP member by contacting the member directly,
  51. ASP may be able to help. The ASP Ombudsman can help you resolve a
  52. dispute or problem with an ASP member, but does not provide technical
  53. support for members' products. Please write to the ASP Ombudsman at
  54. 545 Grover Road, Muskegon, MI 49442-9427 or send a CompuServe message
  55. via CompuServe Mail to ASP Ombudsman 70007,3536.
  56. ======================================================================
  57. Getting Ready for GPSA
  58. =======================
  59.  
  60. System Requirements: DOS 3.3+, 640K RAM, Hard Disk Drive, CGA Monitor 
  61.  
  62. Before installing GPSA, we strongly recommend you view the two demos,
  63. and read the IDEAS.TXT and USERGID.TXT documents.
  64.  
  65. 1. The two demos are:
  66.  
  67.      * INTRO - The Introduction to GPSA presentation shows where GPSA
  68.      fits into the software lifecycle, and then presents four examples
  69.      of using GPSA in software maintenance.
  70.  
  71.      * START - Walks you through all the activities required to load
  72.      source code into an Omni-Relational Model (ORM), view the ORM
  73.      components, and generate reports. DON'T EVEN THINK ABOUT USING
  74.      GPSA UNTIL YOU VIEW THIS DEMO.
  75.  
  76. 2. The IDEAS.TXT file contains ideas and methods for building higher
  77. quality, more maintainable software. GPSA (a complex multi-platform
  78. application) is written in COBOL, and much of the IDEAS material is
  79. the result of experience gained while maintaining GPSA over several
  80. years, platforms, and software versions.
  81.  
  82. 3. USERGID.TXT is the GPSA User Guide. You will need this information
  83. to operate GPSA successfully. In particular, you are advised to read
  84. pages 1 through 22 before attempting to load an ORM.
  85.  
  86. All GPSA documents are created with the following word processor
  87. parameters: [L/R mar:0.9",0.9"][Just:Left][Font:Courier 12cpi] 
  88.  
  89.  
  90. Installing GPSA
  91. ================
  92.  
  93. The installation program (INSTALL.COM) creates the default GPSA
  94. directory structure; checks for the correct DOS version; checks for
  95. sufficient RAM; and unzips GPSA212A.EXE, GPSA212B.EXE, and
  96. GPSA212C.EXE into the C:\GPSA directory.
  97.  
  98. Select the Preview option to review the installation process.
  99.  
  100. YOU must add C:\GPSA to the DOS PATH command of your AUTOEXEC.BAT
  101. file. Alternately, you may want to move the .EXE, .COM, and .BAT files
  102. to a directory already on the DOS PATH command.
  103.  
  104. The GPSA21.LBR and GPSA.INI files MUST be located in the C:\GPSA
  105. directory.
  106.  
  107. For additional installation information, see page 1 of the User Guide.
  108.  
  109. After installing GPSA, check that the GPSA evaluation package is
  110. complete. The 25 files in the GPSA 2.12 evaluation package are listed
  111. in PACKING.LST. Please contact COBOL Maintenance Technologies if any
  112. file is missing.
  113. Responsibilities: Ours and Yours
  114. =================================
  115.  
  116. 1. GPSA version 2.12 is distributed as a shareware program. It is NOT
  117. public domain software, and it is NOT free.
  118.  
  119. 2. Users are granted a limited license to use GPSA version 2.12 on a
  120. trial basis for 30 days, for the purpose of evaluation and determining
  121. if GPSA is suitable for their needs. Use of GPSA, except for this
  122. limited purpose, requires the user to register the product.
  123.  
  124. 3. COBOL Maintenance Technologies specifically grants users the right
  125. to make copies of GPSA version 2.12 for others, providing they
  126. include, unaltered, all files listed in PACKING.LST.
  127.  
  128. 4. Anyone distributing GPSA version 2.12 for any kind of payment must
  129. first contact COBOL Maintenance Technologies at the address below for
  130. authorization. This authorization will automatically be granted to
  131. distributors recognized by the ASP as adhering to its guidelines for
  132. shareware distributors, and such distributors may begin offering GPSA
  133. version 2.12 immediately (however COBOL Maintenance Technologies must
  134. still be advised so the distributor can be kept up-to-date with the
  135. latest version of GPSA.)
  136.  
  137. 5. User Groups, Computer Clubs, Disk Vendors and Distributors,
  138. Subscription Services, etc., should refer to the VENDOR.DOC file for
  139. additional information relating to them.
  140.  
  141. 6. BBS Sysops should refer to the SYSOP.DOC file for additional
  142. information relating to them.
  143.  
  144. 7. No user may modify GPSA in any way, without the express written
  145. permission of the author, including, but not limited to, decompiling,
  146. disassembling, debugging or otherwise reverse-engineering the programs
  147. or screens library.
  148.  
  149. 8. User of GPSA must accept this disclaimer of warranty:
  150. GPSA is supplied as is. COBOL Maintenance Technologies disclaims all
  151. warranties, expressed or implied, including, without limitation, the
  152. warranties of merchantability and of fitness for any purpose. COBOL
  153. Maintenance Technologies assumes no liability for damages, direct,
  154. indirect or consequential, which may result from the use of GPSA.
  155.  
  156.  
  157.           Director of Support Services
  158.           COBOL Maintenance Technologies
  159.           P.O. Box 122069
  160.           Chula Vista, CA  91912-6769
  161.  
  162. What is Shareware?
  163. ===================
  164.  
  165. Shareware distribution gives users a chance to try software
  166. before buying it. If you try a Shareware program and continue
  167. using it, you are expected to register. Individual programs
  168. differ on details -- some request registration while others
  169. require it, some specify a maximum trial period. With
  170. registration, you get anything from the simple right to continue
  171. using the software to an updated program with printed manual.
  172.  
  173. Copyright laws apply to both Shareware and commercial software,
  174. and the copyright holder retains all rights, with a few specific
  175. exceptions as stated below. Shareware authors are accomplished
  176. programmers, just like commercial authors, and the programs are
  177. of comparable quality. (In both cases, there are good programs
  178. and bad ones!) The main difference is in the method of
  179. distribution. The author specifically grants the right to copy
  180. and distribute the software, either to all and sundry or to a
  181. specific group. For example, some authors require written
  182. permission before a commercial disk vendor may copy their
  183. Shareware.
  184.  
  185. Shareware is a distribution method, not a type of software. You
  186. should find software that suits your needs and pocketbook,
  187. whether it's commercial or Shareware. The Shareware system makes
  188. fitting your needs easier, because you can try before you buy.
  189. And because the overhead is low, prices are low also. Shareware
  190. has the ultimate money-back guarantee -- if you don't use the
  191. product, you don't pay for it.
  192.  
  193.  
  194. Registration
  195. =============
  196.  
  197. Please use the registration form in REGISTER.DOC to register your copy
  198. of GPSA. 
  199.  
  200. All users who continue using GPSA Version 2.12 after the 30 day trial
  201. period, must make a registration payment of US$495 to COBOL
  202. Maintenance Technologies. The US$495 registration fee will license one
  203. copy of GPSA for use on any one computer at any one time.
  204.  
  205. Site licenses are available, contact COBOL Maintenance Technologies.
  206.  
  207. Upon REGISTRATION users will receive:
  208.  
  209.      * A printed bound copy of the GPSA User Guide.
  210.      * The most recent release of GPSA.
  211.      * Version 5.11P of DISPLAY.COM. This module provides mouse
  212.      support and much faster screen, window, and menu handling.
  213.      * Free technical support for one year.
  214.      * Notification of upgrades.
  215.  
  216. Support
  217. ========
  218.  
  219. Support is provided by COBOL Maintenance Technologies and is available
  220. to all registered users of GPSA. Phone, fax, and e-mail support is
  221. available on request.
  222.  
  223. All support requests should be sent to:
  224.  
  225.      Director of Support Services
  226.      COBOL Maintenance Technologies
  227.      P.O. Box 122069
  228.      Chula Vista, CA  91912-6769
  229.  
  230.  
  231. Software and documentation upgrades are available for a yearly fee.
  232.  
  233. We want to hear from YOU. GPSA was developed by mainframe COBOL
  234. programmers who wanted more efficient (productive) methods and tools
  235. for maintaining today's large complex software systems. This is a
  236. programmer driven software package--if you're a programmer or
  237. programmer/analyst we want to hear from you.
  238.  
  239. We welcome hearing about your system problems and functional
  240. requirements. Send us a concise description of "where the system is
  241. now, and where you want it to be", and we'll do our best to provide
  242. you with suggestions for formulating solutions. This service is
  243. available to users evaluating GPSA. 
  244.  
  245.  
  246. Planned Enhancements
  247. =====================
  248.  
  249. Support for Structured Query Language (SQL) macros.
  250.  
  251. Support for Job Control Languages (JCL).
  252.  
  253. Link to a Change Request tracking facility.
  254.  
  255. Mainframe version to run under OS/JCL. Please contact us if you are
  256. interested in the mainframe version of GPSA.
  257.  
  258.  
  259. Release Date
  260. =============
  261.  
  262. GPSA version 2.12 was released on January 12th, 1993. 
  263.